MPDeleteQueue

Deletes a message queue.

OSStatus MPDeleteQueue (MPQueueID queue);
queue
A value of type MPQueueID that specifies the ID of the message queue you want to delete.

function result
A result code. See Result Codes for a list of possible values.
DISCUSSION
After calling MPDeleteQueue , the specified queue ID becomes invalid, and all internal resources associated with the queue (including queued messages) are reclaimed. Any tasks waiting on the queue are unblocked and their respective MPWaitOnQueue calls will return with the result code kMPDeletedErr .

VERSION NOTES
Introduced with Multiprocessing Services 1.0.

SEE ALSO
The function MPCreateQueue .


© 1999 Apple Computer, Inc. – (Last Updated 17 Nov 99)